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Getting Started with 5G Toolbox 
Software 


1 Getting Started with 5G Toolbox Software 


5G Toolbox Product Description 

Simulate, analyze, and test the physical layer of 5G communications systems 

5G Toolbox provides standard-compliant functions and reference examples for the 
modeling, simulation, and verification of 5G communications systems. The toolbox 
supports link-level simulation, golden reference verification and conformance testing, and 
test waveform generation. 

With the toolbox you can configure, simulate, measure, and analyze end-to-end 
communications links. You can modify or customize the toolbox functions and use them as 
reference models for implementing 5G systems and devices. 

The toolbox provides reference examples to help you explore baseband specifications and 
simulate the effects of RF designs and interference sources on system performance. You 
can generate waveforms and customize test benches to verify that your designs, 
prototypes, and implementations comply with the 3GPP 5G New Radio (NR) standard. 

Key Features 

• Standard-compliant models for 3GPP 5G NR Release 15 

• Link-level simulation with reference examples, including 5G NR PDSCH throughput 
simulation 

• OFDM waveform generation with NR subcarrier spacings and frame numerologies 

• TR 38.901 propagation channel models, including tapped delay line (TDL) and 
clustered delay line (CDL) 

• Downlink transport and physical channels (shared, control, broadcast); 
synchronization and demodulation reference signals 

• Signal processing functions, including channel coding (LDPC and polar codes), 
channel estimation, synchronization, and equalization 

• C and C++code generation support 
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About 5G 


2 About 5G 


What Is 5G New Radio? 

New Radio (NR) is the air interface supporting the next generation of mobile 
communication, commonly referred to as fifth generation or 5G. 

The predecessors of 5G NR are GSM, UMTS, and LTE, also referred to as second 
generation (2G), third generation (3G), and fourth generation (4G) technologies, 
respectively. GSM primarily enabled voice calls. The redesigned interfaces of UMTS and 
LTE enabled and gradually improved mobile broadband connectivity with high data rates 
and high efficiency. 

5G NR continues on the path of LTE by enabling much higher data rates and much higher 
efficiency for mobile broadband. However, as a response to the demands of networked 
society, the scope of 5G NR goes beyond mobile broadband connectivity. The main 
reguirement of 5G NR is to enable wireless connectivity everywhere, at any time to 
anyone and anything. 

The wide range of use cases that drive 5G NR are classified by three main scenarios. 

• Enhanced mobile broadband (eMBB) — This scenario is still the most important usage 
scenario that addresses human-centric communications. eMBB use cases have various 
challenges. For example, hot spots reguire higher data rates, higher user density, and 
a need for high capacity. Wide area coverage stresses mobility and seamless user 
experience with lower reguirements on data rate and user density. 

• Massive machine type communications (mMTC) — This scenario addresses pure 
machine-centric use cases characterized by a large number of connected devices. 
Typically, the data rate reguirement of mMTC applications is low. However, the use 
cases demand a high connection density locally, low cost, and long battery life. 

• Ultra reliable and low latency communications (URLLC) — This scenario covers both 
human-centric communication and critical machine-type communication (C-MTC) that 
demand low latency, reliability, and high availability. Typical URLLC use cases include 
3-D gaming, self driving cars, mission-critical applications, remote medical surgery, 
and wireless control of industrial eguipment. 

This classification is based on presently foreseen use cases and identifies key capabilities 
of 5G NR. Based on these capabilities, the 5G NR interface is designed to easily adapt to 
unforeseen use cases that will evolve and emerge over time. 
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What Is 5G New Radio? 


Scope of 5G Toolbox 

The 5G NR specification is developed by the Third Generation Partnership Project (3GPP). 
The first release of the standard was frozen in mid-2018 as 3GPP 5G NR Release 15. 

5G Toolbox provides implementations for a subset of the 5G NR physical layer 
specification and channel model specifications. The following diagram highlights the 
scope of 5G Toolbox in terms of the addressed specifications and their connectivity. 
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2 About 5G 


References 

[1] Dalman, E., S. Parkvall, and J. Skold. 4G, LTE-Advanced Pro and The Road to 5G. 
Kidlington, Oxford: Academic Press, 2016. 

See Also 

More About 

• "5G Toolbox and the 5G NR Protocol Layers" on page 2-5 

• "What Is LTE?" (LTE Toolbox) 

External Websites 

• http://www.3gpp.org 
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5G Toolbox and the 5G NR Protocol Layers 

The 5G NR radio access network is comprised of these protocol entities: 

• Service data adaptation protocol (SDAP) 

• Packet data convergence protocol (PDCP) 

• Radio link control (RLC) 

• Medium access control (MAC) 

• Physical layer (PHY) 

The SDAP protocol is new in 5G NR compared to the LTE protocol stack. SDAP handles 
the new QoS framework of the 5G System (in the 5G Core). SDAP applies also to LTE 
when connected to the 5G Core. The introduction of SDAP enables end-to-end QoS 
framework that works in both directions. 

To meet the desired key capabilities of 5G NR, the other layers of the stack provide 
various enhancements over their LTE counterparts. The PDCP, RLC, and MAC protocols 
handle tasks such as header compression, ciphering, segmentation and concatenation, 
and multiplexing and demultiplexing. PHY handles coding and decoding, modulation and 
demodulation, and antenna mapping. 

This figure shows the 5G NR user plane protocol stack for user eguipment (UE) and the 
NR radio access network node (gNB). 5G Toolbox supports the 5G NR physical layer, 
including physical channels and signals. The toolbox also supports interfacing with 
portions of the RLC and MAC layers, including transport channels and logical channels. 
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5G Toolbox and the 5G NR Protocol Layers 


Downlink Channel Mapping 

5G NR system downlink data follows the mapping between logical channels, transport 
channels, and physical channels, as indicated in the diagram. 5G Toolbox provides the 
red-highlighted downlink functionality for physical channels, transport channels, and 
control information. 


Logical Channels PCCH 


Physical Channels 


Transport Channels PCH 


BCCH CCCH DTCH DCCH 

___ 
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m cru 
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u l jL n 
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PDCCH 


5G Toolbox™ 


For more details, see "Downlink Channels" or the specific downlink channel: 

• "Downlink Physical Signals" 

• "Downlink Physical Channels" 
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• "Downlink Transport Channels" 

• "Downlink Control Information" 


Uplink Channel Mapping 

5G NR system uplink data follows the mapping between logical channels, transport 
channels, and physical channels, as indicated in the diagram. 5G Toolbox provides the 
red-highlighted uplink functionality for physical channels, transport channels, and control 
information. 


Logical Channels 


Transport Channels 


Physical Channels 




5G Toolbox™ 


For more details, see "Uplink Channels" or the specific uplink channel: 

• "Uplink Physical Channels" 

• "Uplink Transport Channels" 
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See Also 


• "Uplink Control Information" 

References 

[1] 3GPP TS 38.212. "NR; Multiplexing and channel coding." 3rd Generation Partnership 

Project; Technical Specification Group Radio Access Network. 

[2] 3GPP TS 38.300. "NR; NR and NG-RAN Overall Description." 3rd Generation 

Partnership Project; Technical Specification Group Radio Access Network. 


See Also 


More About 

• "What Is 5G New Radio?" on page 2-2 

External Websites 

• http://www.3gpp.org 
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3 Tutorials 


5G NR Downlink Carrier Waveform Generation 


This example implements a 5G NR downlink carrier waveform generator using 5G 
Toolbox™. 

Introduction 

This example shows how to parameterize and generate a 5G New Radio (NR) downlink 
waveform. The following channels and signals are generated; 

• PDSCH and its associated DM-RS 

• PDCCH and its associated DM-RS 

• PBCH and its associated DM-RS 

• PSS and SSS 


This example supports the parameterization and generation of multiple SCS specific 
carriers and multiple bandwidth parts (BWP). Multiple instances of the PDSCH and 
PDCCH channels can be generated over the different BWPs. Sets of CORESETs and 
search space monitoring opportunities can be configured for mapping the PDCCHs. Note 
that no precoding is applied to the physical channels and signals in this example. 

Waveform and Carrier Configuration 


This section sets the SCS specific carrier bandwidths in resource blocks, the cell ID, and 
the length of the generated waveform in subframes. You can visualize the generated 
resource grids by setting the DisplayGrids field to 1. The channel bandwidth and 
frequency range parameters are used to display the associated minimum guardbands on a 
schematic diagram of the SCS carrier alignment. 


waveconfig = []; 
waveconfig.NCelllD = 0; 
waveconfig.ChannelBandwidth = 40; 
waveconfig.FrequencyRange = 'FR1' ; 
waveconfig.NumSubframes = 10; 
waveconfig.DisplayGrids = 1; 


% Cell identity 
% Channel bandwidth (MHz) 

% 'FR1 1 or 1 FR2 1 

% Number of 1ms subframes in generated waveform (1,; 
% Display the resource grids after signal generatioi 


% Define a set of SCS specific carriers, using the maximum sizes for a 

% 40 MHz NR channel. See TS 38.101-1 for more information on defined 

% bandwidths and guardband requirements 

carriers(l).SubcarrierSpacing = 15; 

carriers(l).NRB = 216; 

carriers(l).RBStart = 0; 
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carriers(2).SubcarrierSpacing = 30; 
carriers(2).NRB = 106; 
carriers(2).RBStart = 1; 

SS Burst 


In this section you can set the parameters for the SS burst. The numerology of the SS 
burst can be different from other parts of the waveform. This is specified via the block 
pattern parameter as specified in TS 38.213 Section 4.1. A bitmap is used to specify 
which blocks are transmitted in a 5ms half-frame burst. The periodicity in milliseconds 
and the power of the burst can also be set here. Other SS burst parameters not shown 
here can also be set. For the full list see the help for hSSBu rst. 


% SS burst configuration 
ssburst = []; 
ssburst.Enable = 1; 
ssburst.BlockPattern = 'Case B 1 ; 
ssburst.SSBTransmitted =[111 
ssburst.SSBPeriodicity = 20; 
ssburst.FrequencySSB = 0*5000; 
ssburst.Power = 0; 


1 ] 


Bandwidth Parts 


% Enable SS Burst 

% Case B (30kHz) subcarrier spacing 
% Bitmap indicating blocks transmitted in a 5m: 
% SS burst set periodicity in ms (5, 10, 20, 4( 
% Frequency offset of SS burst (Hz), relative i 
% Power scaling in dB 


A BWP is formed by a set of contiguous resources sharing a numerology on a given 
carrier. This example supports the use of multiple BWPs using a structure array. Each 
entry in the array represents a BWP. For each BWP you can specify the subcarrier spacing 
(SCS), the cyclic prefix (CP) length and the bandwidth. The SubcarrierSpacing 
parameter maps the BWP to one of the SCS specific carriers defined earlier. The 
RBOf f set parameter controls the location of the BWP in the carrier. This is expressed in 
terms of the BWP numerology. Different BWPs can overlap with each other. 
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% Bandwidth parts configurations 
bwp = []; 

bwp(l).SubcarrierSpacing = 15; 
bwp(l).CyclicPrefix = 'Normal 1 ; 
bwp(l).NRB = 25; 
bwp(l).RBOffset = 10; 

bwp(2).SubcarrierSpacing = 30; 
bwp(2).CyclicPrefix = 'Normal'; 
bwp(2).NRB = 50; 
bwp(2).RBOffset = 50; 


% BWP Subcarrier Spacing 
% BWP Cyclic prefix for 15 kHz 
% Size of BWP 

% Position of BWP in SCS carrier 

% BWP Subcarrier Spacing 
% BWP Cyclic prefix for 30 kHz 
% Size of BWP 

% Position of BWP in SCS carrier 


CORESET and Search Space Configuration 


The parameters in this section specify the control resource set (CORESET) and the 
PDCCH search space configuration. The CORESET specifies the possible locations (in 
time and frequency) of the control channel for a given numerology. This example supports 
multiple CORESETs. The following parameters can be specified: 

• Allocated OFDM symbols: specifies the first symbol of each CORESET monitoring 
opportunity in a slot 

• The allocated slots within a period 
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Bandwidth part (BWP) 


5G NR Downlink Carrier Waveform Generation 


• Periodicity of the allocation. If this is set to empty it indicates no repetition 

• CORESET duration in symbols, either 1, 2 or 3. 

• The first PRB of the allocation. Note that the allocation is in blocks of 6 PRBs. 

Note that this example only supports non-interleaved CCE-to-REG mapped CORESETs. 
The figure below shows the meaning of the CORESET parameters. 


Allocated 
slots: 0 & 1 


Slot #0 Slot #1 Slot #2 Slot #3 Slot #4 Slot #5 Slot #6 Slot #7 Slot #8 Slot #9 

--►«-- 


Period: 5 slots 


Period: 5 slots 


Allocated 

PRBs 


mi 


INI 


Allocated 

PRBs 


PRB indices: 
0, 6 & 18 



Duration: Allocated 

3 symbols symbo | s:0&7 



% CORESET/search configurations 
coreset = []; 

coreset(l).AllocatedSymbols = [0,7]; 
coreset(l).AllocatedSlots = [0,1]; 
coreset(l).AtlocatedPeriod = 5; 
coreset(l).Duration = 3; 
coreset(l).AltocatedPRB = 6*[0,1,3]; 


% First symbol of each CORESET monitoring oppo 
% Allocated slots within a period 
% Allocated slot period (empty implies no repe 
% CORESET symbol duration (1,2,3) 

% 6 REG sized indices, relative to BWP (RRC - 


PDCCH Instances Configuration 


This section specifies the parameters for the set of PDCCH instances in the waveform. 
Each element in the structure array defines a PDCCH seguence instance. The following 
parameters can be set: 

• Enable/disable the PDCCH seguence 
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• Specify the BWP carrying the PDCCH 

• PDCCH instance power in dB 

• Enable/disable DCI channel coding 

• Allocated search spaces: indices within the corresponding CORESET where to map the 
PDCCH 

• CORESET which carries the PDCCH instance 

• Periodicity of the allocation. If this is set to empty it indicates no repetition 

• Number of control channel elements (CCEs) in this PDCCH 

• NumCCE and Sta rtCCE specify the elements used for the transmission of this PDCCH 

• RNTI 

• Scrambling NID for this PDCCH and its associated DM-RS 

• DM-RS power boosting 

• DCI message payload size 

• DCI message data source. You can use one of the following standard PN seguences: 
'PN9-ITU', 'PN9', 'PNIT, 'PN15', 'PN23'. The seed for the generator can be specified 
using a cell array in the form { ' PN9 ', seed}. If no seed is specified, the generator is 
initialized with all ones 

pdcch = []; 
pdcch(l).Enable = 1; 
pdcch(1).BWP = 1; 
pdcch(1).Power = 1.1; 
pdcch(1).EnableCoding = 1; 
pdcch(1).AllocatedSearchSpaces 
pdcch(1).CORESET = 1; 
pdcch(1).AllocatedPeriod = 4; 
pdcch(1).NumCCE = 8; 
pdcch(1).StartCCE = 0; 
pdcch(1).RNTI = 0; 
pdcch(1).NID = 1; 
pdcch(1).PowerDMRS = 0; 
pdcch(1).DataBlkSize = 20; 
pdcch(1).DataSource = 1 PN9 1 ; 

PDSCH Instances Configuration 

This section specifies the set of PDSCH instances in the waveform. Each element in the 
structure array defines a PDSCH seguence instance. This example defines two PDSCH 
seguence instances. 


% Enable PDCCH sequence 
% Bandwidth part 
% Power scaling in dB 
% Enable DCI coding 
= [0,3]; % Index within the CORESET 

% Control resource set ID which carries this PI 
% Allocation slot period (empty implies no rep< 
% Number of CCE used by PDCCH 
% Starting CCE of PDCCH 
% RNTI 

% PDCCH and DM-RS scrambling NID 
% Additional power boosting in dB 
% DCI payload size 
% DCI data source 
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General Parameters 

The following parameters are set for each instance: 

• Enable/disable this PDSCH sequence 

• Specify the BWP carrying the PDSCH. The PDSCH will use the SCS specified for this 
BWP 

• Power scaling in dB 

• Enable/disable DL-SCH transport channel coding 

• Transport block data source. You can use one of the following standard PN sequences: 
'PN9-ITU', 'PN9\ 'PN1T, 'PN15', 'PN23'. The seed for the generator can be specified 
using a cell array in the form { ' PN9 1 , seed}. If no seed is specified, the generator is 
initialized with all ones 

• Target code rate used to calculate the transport block sizes 

• Overhead parameter 

• Symbol modulation 

• Number of layers 

• Redundancy version (RV) sequence 

pdsch = []; 
pdsch(l).Enable = 1; 
pdsch(1).BWP = 1; 
pdsch(1).Power = 0; 
pdsch(l).EnableCoding = 1; 
pdsch(1).DataSource = 1 PN9 1 ; 
pdsch(1).TargetCodeRate = 0.4785; 
pdsch(1).Xoh_PDSCH = 0; 
pdsch(1).Modulation = 'QPSK 1 ; 
pdsch(1).NLayers = 2; 
pdsch( 1 ).RVSequence = [0,2, 3,1]; 

Allocation 

The following diagram represents some of the parameters used in the PDSCH allocation. 


% Enable PDSCH sequence 
% Bandwidth part 
% Power scaling in dB 

% Enable DL-SCH transport channel coding 
% Channel data source 

% Code rate used to calculate transport block : 
% Rate matching overhead 
% 'QPSK', 1 16QAM 1 , 1 64QAM 1 , '256QAM' 

% Number of PDSCH layers 

% RV sequence to be applied cyclically across i 
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You can set the following parameters to control the PDSCH allocation. Note that these 
parameters are relative to the BWP. The specified PDSCH allocation will avoid the 
locations used for the SS burst. 


• Symbols in a slot allocated to each PDSCH instance 

• Slots in a frame used for the sequence of PDSCH 

• Period of the allocation in slots. If this is empty it indicates no repetition 

• The allocated PRBs are relative to the BWP 

• RNTI. This value is used to links the PDSCH to an instance of the PDCCH 

• NID for scrambling the PDSCH bits 


pdsch(l).AllocatedSymbols = 2:10; 
pdsch(l).AllocatedSlots = [0:9]; 
pdsch(l).AllocatedPeriod = 15; 
pdsch(l).AllocatedPRB = [0:5, 10:20]; 


% Range of symbols in a slot 
% Allocated slot indices for PDSCH sequence 
% Allocation period in slots (empty implies no i 
% PRB allocation 
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pdsch(l).RNTI =0; % RNTI 

pdsch(l).NID =1; % Scrambling for data part 

Note that the generator in this example does not check for inter-channel conflict. 

However, additional parameters can be specified for rate matching around other 
resources, if reguired 

• The PDSCH can be rate matched around one or more CORESETs 

• The PDSCH can be rate matched around other resource allocations 

pdsch(l).RateMatch(1).CORESET = [1]; % Rate matching pattern, defined 

pdsch(l).RateMatch(1).Pattern.AllocatedPRB = []; % Rate matching pattern, defined 

pdsch(l).RateMatch(1).Pattern.AllocatedSymbols = []; 
pdsch(l).RateMatch(1).Pattern.AllocatedSlots = []; 
pdsch(l).RateMatch(1).Pattern.AllocatedPeriod = []; 

PDSCH DM-RS Configuration 


The following DM-RS parameters can be set 


% Antenna port and DM-RS configuration 
pdsch(l).PortSet = 0 :pdsch(1).NLayers-1; 
pdsch(l).PDSCHMappingType = 'A'; 
pdsch(l).DMRSTypeAPosition = 2; 
pdsch(l).DMRSLength = 1; 
pdsch(l).DMRSAdditionalPosition = 0; 
pdsch(l).DMRSConfigurationType = 2; 
pdsch(l).NumCDMGroupsWithoutData = 0; 
pdsch(1).NIDNSCID = 1; 
pdsch(l).NSCID = 0; 
pdsch(1).PowerDMRS = 0; 


(TS 38.211 section 7.4.1.1) 

% DM-RS antenna ports used 

% PDSCH mapping type ('A 1 (slot-wise), 1 B 1 (non < 
% Mapping type A only. First DM-RS symbol pos: 
% Number of front-loaded DM-RS symbols (1(sine 
% Additional DM-RS symbol positions (max range 
% DM-RS configuration type (1,2) 

% CDM groups without data (max range 0...3) 

% Scrambling identity (0...65535) 

% Scrambling initialization (0,1) 

% Additional power boosting in dB 


Specifying Multiple PDSCH Instances 


A second PDSCH seguence instance is specified next using the second BWP. 

pdsch(2) = pdsch(l); 
pd s c h(2).Enable = 1; 

pdsch(2).BWP =2; % PDSCH mapped to 2nd BWP 

pd s c h(2).AllocatedSymbols = 0:11; 
pdsch(2).AllocatedSlots = [2:4,6:20]; 

pdsch(2).AllocatedPRB = [25:30, 35:38]; % PRB allocation, relative to BWP 
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Waveform Generation 

This section collects all the parameters into the carrier configuration and generates the 
waveform. 

% Collect together channel oriented parameter sets into a single 

% configuration 

waveconfig.SSBurst = ssburst; 

waveconfig.Carriers = carriers; 

waveconfig.BWP = bwp; 

waveconfig.CORESET = coreset; 

waveconfig.PDCCH = pdcch; 

waveconfig.PDSCH = pdsch; 

% Generate complex baseband waveform 

[waveform,bwpset] = hNRDownlinkWaveformGenerator(waveconfig); 
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The waveform generator also plots the resource grids for the bandwidth parts (this is 
controlled by the field DisplayGridsin the carrier configuration). The following plots 
are generated: 

• The SCS specific carrier resource grids, along with the minimum guardbands, aligned 
relative to the overall channel bandwidth. 

• Resource grids showing the location of the components (PDCCH, PDSCH, and 
CORESET) in each BWP. This does not plot the power of the signals, just their location 
in the grid. 

• Generated waveform in the freguency domain for each BWP. This includes the PDCCH 
and PDSCH instances. 
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Note that none of these resource grids include the SS burst which is independent of the 
BWPs. 

The waveform generator function returns the time domain waveform and a structure 
array bwpset, which contains the following fields: 

• The resource grid corresponding to this BWP 

• The resource grid of the overall bandwidth containing the channels and signals in this 
BWP 

• An info structure with information corresponding to the BWP. The contents of this info 
structure for the first BWP are shown below. 


disp( 1 Information associated to BWP 1:') 
disp(bwpset(l).Info) 


Information associated to BWP 1: 


SamplingRate 
Nf ft 


61440000 

4096 


Windowing 
CycticPrefixLengths 
SymbolLengths 
NSubcarriers 
SubcarrierSpacing 
SymbolsPerSlot 
SlotsPerSubframe 
SymbolsPerSubframe 
SamplesPerSubframe 
SubframePeriod 
Midpoints 
WindowOverlap 
k0 


10 

[1x14 double] 

[1x14 double] 

2592 

15 

14 

1 

14 

61440 

1.0OOOe-03 
[1x141 double] 

[10 10 10 10 10 10 10 10 10 10 10 10 10 10 ] 
0 


Note that the generated resource grid is a 3D matrix where the different planes represent 
the antenna ports. For the different physical channels and signals the lowest port is 
mapped to the first plane of the grid. 


See Also 

Functions 

nrPBCH I nrPBCHDMRS I nrPDCCH I nrPDSCH I nrPSS I nrSSS 
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More About 

• "5G NR Uplink Carrier Waveform Generation" on page 3-16 
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5G NR Uplink Carrier Waveform Generation 

This example implements a 5G NR uplink carrier waveform generator using 5G Toolbox™. 

Introduction 

This example shows how to parameterize and generate a 5G New Radio (NR) uplink 
waveform. The following channels and signals are generated 

• PUSCH and its associated DM-RS 

• PUCCH and its associated DM-RS 


This example supports the parameterization and generation of multiple bandwidth parts 
(BWP). Multiple instances of the PUSCH and PUCCH channels can be generated over the 
different BWPs. The example allows to configure PUCCH and PUSCH for a specific UE 
categorized by RNTI and transmits only PUSCH for that specific RNTI when both PUCCH 
and PUSCH overlap in a slot. 

Waveform and Carrier Configuration 


This section sets the subcarrier spacing (SCS) specific carrier bandwidths in resource 
blocks, the physical layer cell identity NCelllD, and the length of the generated waveform 
in subframes. You can visualize the generated resource grids by setting the 
DisplayGrids field to 1. The channel bandwidth and freguency range parameters are 
used to display the associated minimum guardbands on a schematic diagram of the SCS 
carrier alignment. The schematic diagram is displayed in one of the output plots of the 
example. 


waveconfig = []; 
waveconfig.NCelllD = 0; 
waveconfig.ChannelBandwidth = 50; 
waveconfig.FrequencyRange = 1 FR1' ; 
waveconfig.NumSubframes = 10; 


waveconfig.DisplayGrids = 1; 


% Cell identity 
% Channel bandwidth (MHz) 

% 1 FR1' or 1 FR2 1 

% Number of 1ms subframes in generated waveform 
% (1,2,4,8 slots per 1ms subframe, 

% depending on SCS) 

% Display the resource grids after signal generatior 


% Define a set of SCS specific carriers, using the maximum sizes for a 50 
% MHz NR channel. See TS 38.101-1 for more information on defined 
% bandwidths 
carriers = []; 

carriers(l).SubcarrierSpacing = 15; 
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carriers(l).NRB = 270; 
carriers(l).RBStart = 0; 

carriers(2).SubcarrierSpacing = 30; 
carriers(2).NRB = 133; 
carriers(2).RBStart = 1; 

Bandwidth Parts 

A BWP is formed by a set of contiguous resources sharing a numerology on a given SCS 
specific carrier. This example supports the use of multiple BWPs using a struct array. 
Each entry in the array represents a BWP. For each BWP you can specify the subcarrier 
spacing (SCS), the cyclic prefix (CP) length and the bandwidth. The 
SubcarrierSpacing parameter maps the BWP to one of the SCS specific carriers 
defined earlier. The RBOf f set parameter controls the location of the BWP in the carrier. 
This is expressed in terms of the BWP numerology. Different BWPs can overlap with each 
other. 


CO 

a: 


U 

uo 

U 

to 

N 

X 


BWP NRB 


BWP RBOffset 


BWP 

30 kHz SCS, normal CP 


BWP 

IS kHz SCS, normal CP 


Point A 


RBStart 2 I 


BWP NRB 


BWP RBOffset 

RBStart 1 


% Bandwidth parts configurations 
bwp = []; 

bwp(l).SubcarrierSpacing = 15; 
bwp(l).CyclicPrefix = 'Normal 1 ; 
bwp(l).NRB = 25; 


% BWP1 Subcarrier Spacing 
% BWP1 cyclic prefix 
% Size of BWP1 
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bwp(l).RBOffset = 10; 

bwp(2).SubcarrierSpacing = 30; 
bwp(2).CyclicPrefix = 'Normal 1 ; 
bwp(2).NRB = 51; 
bwp(2).RBOffset = 40; 

PUCCH Instances Configuration 


% Position of BWP1 in carrier 

% BWP2 Subcarrier Spacing 
% BWP2 cyclic prefix 
% Size of BWP2 

% Position of BWP2 in carrier 


This section specifies the parameters for the set of PUCCH instances in the waveform. 
Each element in the structure array defines a PUCCH sequence instance. The following 
parameters can be set: 


• Enable/disable the PUCCH sequence 

• Specify the BWP carrying the PUCCH 

• PUCCH instance power in dB 

• Slots within a period used for PUCCH 

• Periodicity of the allocation. Use empty to indicate no repetition 

• DM-RS power boosting in dB 


pucch = []; 

pucch(l).Enable = 1; 

pucch(l).BWP = 1; 

pucch(l).Power = 0; 

pucch(l).AllocatedSlots = [34]; 

pucch(l).AllocatedPeriod = 6; 

pucch(1).PowerDMRS = 1; 


% Enable PUCCH sequence 
% Bandwidth part 
% Power scaling in dB 
% Allocated slots within a period 
% Allocation slot period (empty implies no 
% Additional power boosting in dB 


PUCCH Resource Configuration 


This section specifies the PUCCH sequence resource related parameters. The parameters 
can be categorized into the following sections: 

• Enable/Disable the PUCCH dedicated resource. If this is disabled, it uses common 
resource as per TS 38.213 Section 9.2.1. 

• Provide the resource index value (0...15) when dedicated resource is disabled and the 
cyclic prefix of BWP transmitting PUCCH is normal. In this case, the resource and 
format parameters for the PUCCH transmission are filled up directly based on the 
resource index. All the other parameters that are provided for resource and format 
configurations are not considered. 
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When the dedicated resource is enabled or when the dedicated resource is disabled with 

the cyclic prefix of BWP transmitting PUCCH is extended, the following resource 

parameters need to be provided: 

• Specify the index of first PRB prior to freguency hopping or for no freguency hopping 
within the BWP 

• Specify the index of first PRB after freguency hopping within the BWP 

• Intra-slot freguency hopping configuration ('enabled 1 ,'disabled') 

• Group hopping configuration ('neither','enable','disable') 

and the following format specific parameters need to be provided: 

• PUCCH format configuration in the resource (0...4) 

• Starting symbol index allocated for PUCCH transmission 

• Number of OFDM symbols allocated for PUCCH transmission. For PUCCH formats 1, 3 
and 4, the number of OFDM symbols allocated are in range 4 to 14, and for formats 0 
and 2, it is either 1 or 2 

• Initial cyclic shift for formats 0 and 1. The value is in range 0 to 11 

• Modulation scheme for formats 3 and 4 ('QPSK','pi/2-BPSK') 

• Number of resource blocks allocated for format 2 and 3. The nominal value is one of 
the set {1,2,3,4,5,6,8,9,10,12,15,16} 

• Spreading factor for format 4. The value is either 2 or 4 

• Orthogonal cover code index for formats 1 and 4. For format 1, the value is in range 0 
to 6. For format 4, the value is less than spreading factor and greater than or egual to 
0 

• Indicate the presence of additional DM-RS for formats 3 and 4. The value is either 0 or 
1 

Scrambling identities to be used for different formats 

• RNTI for formats 2/3/4. It is used for seguence generation. It is in range 0 to 65535 

• Scrambling identity (NID) for PUCCH formats 2/3/4. It is in range 0 to 1023. Use 
empty ([]) to use physical layer cell identity. It is used in seguence generation. This 
parameter is provided by higher-layer parameter dataScramblingldentityPUSCH 

• PUCCH hopping identity for formats 0/1/3/4. Use empty ([]) to use physical layer cell 
identity. The value is used in seguence generation for format 0, both seguence and 
DM-RS generation for format 1 and only for DM-RS generation for formats 3 and 4 
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• DM-RS scrambling NID for PUCCH format 2. It is in range 0 to 65535. Use empty ([]) 
to use physical layer cell identity 

Irrespective of dedicated resource configuration, the following parameters are to be 
provided for slot repetitions: 

• Specify the number of slot repetitions for formats 1,3,4 (2 or 4 or 8). For no slot 
repetition, the value can be specified as 1 

• Specify the inter-slot frequency hopping for formats 1,3,4 ('enabled 1 ,'disabled'). If this 
is enabled and the number of slot repetitions is more than one, then intra-slot 
frequency hopping is disabled 

• Specify the maximum code rate. The nominal value is one of the set {0.08, 0.15, 0.25, 

0.35, 0.45, 0.6, 0.8} 

% Dedicated resource parameters 

pucch(l).DedicatedResource =1; % Enable/disable the dedicated resource coi 

% Provide the resource index value when dedicated resource is disabled. The 
% PUCCH resource is configured based on the resource index value, as per 
% the table 9.2.1-1 of Section 9.2.1, TS 38.213. 

pucch(l).Resourcelndex =0; % Resource index for PUCCH dedicated resoui 

% When dedicated resource is enabled or when the dedicated resource is 
% disabled with the cyclic prefix of BWP transmitting PUCCH is extended, 

% the resource index value is ignored and the parameters specified below 
% for the resource and format configurations are considered. 


% Resource parameters 

pucch(l).StartPRB = 0; 

pucch(l).SecondHopPRB = 1; 

pucch(l).IntraSlotFreqHopping = 'enabled'; 

pucch(l).GroupHopping = 'enable'; 

% Format specific parameters 
pucch(l).PUCCHFormat = 3; 
pucch(l).StartSymbol = 3; 
pucch(l).NrOfSymbols = 11; 
pucch(l).Initiates = 3; 
pucch(l).OCCI = 0; 
pucch(l).Modulation = ' QPSK' ; 
pucch(l).NrOfRB = 9; 
pucch(l).SpreadingFactor = 4; 
pucch(l).AdditionalDMRS = 1; 


% Index of first PRB prior to frequency ho[ 
% Index of first PRB after frequency hoppit 
% Indication for intra-slot frequency hopp; 
% Group hopping configuration ('enable','d; 


% PUCCH format 0/1/2/3/4 
% Starting symbol index 

% Number of OFDM symbols allocated for PUC( 
% Initial cyclic shift for format 0 and 1 
% Orthogonal cover code index for format 1 
% Modulation for format 3/4 ('pi/2-BPSK','( 
% Number of resource blocks for format 2/3 
% Spreading factor for format 4, value is < 
% Additional DM-RS (0/1) for format 3/4 
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% Scrambling identities of 
pucch(l).RNTI = 0; 
pucch(l).NID = 1; 
pucch(l).Hoppingld = 1; 
pucch(l).NIDDMRS = 1; 


PUCCH and PUCCH DM-RS 

% RNTI (0...65535) for formats 2/3/4 
% PUCCH scrambling identity (0...1023) for 
% PUCCH hopping identity (0...1023) for foi 
% DM-RS scrambling identity (0...65535) foi 


% Multi-slot configuration parameters 

pucch(l).NrOfSlots =1; % Number of slots for PUCCH repetition (1/; 

pucch(l).InterSlotFreqHopping = 'disabled'; % Indication for inter-slot frequency hopp; 


% Code rate - This parameter is used when there is multiplexing of UCI part 

% 1 (HARQ-ACK, SR, CSI part 1) and UCI part 2 (CSI part 2) to get the rate 

% matching lengths of each UCI part 

pucch(l).MaxCodeRate = 0.15; % Maximum code rate (0.08, 0.15, 0.25, 0.3! 

UCI payload configuration 

Configure the UCI payload based on the format configuration 

• Enable or disable the UCI coding for formats 2/3/4 

• Number of HARQ-ACK bits. For formats 0 and 1, value can be at most 2. Set the value 
to 0, for no HARQ-ACK transmission 

• Number of SR bits. For formats 0 and 1, value can be at most 1. Set the value to 0, for 
no SR transmission 

• Number of CSI part 1 bits for formats 2/3/4. Set value to 0, for no CSI part 1 
transmission 

• Number of CSI part 2 bits for formats 3/4. Set value to 0, for no CSI part 2 
transmission. The value is ignored when there are no CSI part 1 bits 


Note that the generator in the example transmits UCI information on PUSCH whenever 
there is a overlap between PUCCH and PUSCH for a specific RNTI in a BWP The 
parameters to be configured for UCI transmission on PUSCH are provided in the section 
UCI on PUSCH. It requires the lengths of UCI and UL-SCH to be transmitted on PUSCH. 


pucch(l).EnableCoding = 1; 
pucch(l).LenACK = 5; 
pucch(l).LenSR = 5; 
pucch(l).LenCSIl = 10; 
pucch(l).LenCSI2 = 10; 


% Enable UCI coding 
% Number of HARQ-ACK bits 

% Number of SR bits 

% Number of CSI part 1 bits (for formats 2, 

% Number of CSI part 2 bits (for formats 3, 


pucch(l).DataSource = ' PN9' ; 


% UCI data source 
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% UCI message data source. You can use one of the following standard PN 
% sequences: 1 PN9-ITU 1 , 1 PN9 1 , 1 PN11 1 , 'PN15', 'PN23'. The seed for the 
% generator can be specified using a cell array in the form |{ 1 PN9 1 ,seed}|. 

% If no seed is specified, the generator is initialized with all ones 

Specifying Multiple PUCCH Instances 

A second PUCCH sequence instance is specified next using the second BWP. 

% PUCCH sequence instance specific to second BWP 

pucch(2) = pucch(l); 

pucch(2).BWP = 2; 

pucch(2).StartSymbol = 10; 

pucch(2).NrOfSymbols = 2; 

pucch(2).PUCCHFormat = 2; 

pucch(2).AllocatedSlots = 0:2; 

pucch(2).AllocatedPeriod = []; 

pucch(2).RNTI = 10; 

PUSCH Instances Configuration 

This section specifies the set of PUSCH instances in the waveform using a struct array. 
This example defines two PUSCH sequence instances. 

General Parameters 

The following parameters are set for each instance: 

• Enable/disable this PUSCH sequence 

• Specify the BWP this PUSCH maps to. The PUSCH will use the SCS specified for this 
BWP 

• Power scaling in dB 

• Enable/disable the UL-SCH transport coding 

• Scrambling identity (NID) for PUSCH bits. It is in range 0 to 1023. Use empty ([]) to 
use physical layer cell identity 

• RNTI 

• Transform precoding (0,1). The value of 1, enables the transform precoding and the 
resultant waveform is DFT-s-OFDM. When the value is 0, the resultant waveform is CP- 
OFDM 

• Target code rate used to calculate the transport block sizes. 
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• Overhead parameter. It is used to calculate the length of transport block size. It is one 
of the set {0, 6, 12, 18} 

• Transmission scheme ('codebook 1 ,'nonCodebook'). When the transmission scheme is 
'codebook', the MIMO precoding is enabled and a precoding matrix is selected based 
on the number of layers, number of antenna ports and the transmitted precoding 
matrix indicator. When the transmission is set to 'nonCodebook 1 , an identity matrix is 
used, leading to no MIMO precoding 

• Modulation scheme ('pi/2-BPSK', 'QPSK', '16QAM', '64QAM', '256QAM'). Nominally, 
the modulation scheme 'pi/2-BPSK' is used when transform precoding is enabled 

• Number of layers (1 ...4). The number of layers is restricted to a maximum of 4 in 
uplink as there is only one code word transmission. Nominally, the number of layers is 
set to 1 when transform precoding is enabled 

• Number of antenna ports (1,2,4). It is used when codebook transmission is enabled. 
The number of antenna ports must be greater than or egual to number of layers 

• Transmitted precoding matrix indicator (0...27). It depends on the number of layers 
and the number of antenna ports 

• Redundancy version (RV) sequence 

• Intra-slot frequency hopping ('enabled','disabled') 

• Resource block offset for second hop. It is used when frequency (Intra-slot/Inter-slot) 
hopping is enabled 

• Inter-slot frequency hopping ('enabled','disabled'). If this is enabled, intra-slot 
frequency hopping is disabled, the starting position of resource block in the allocated 
PRB of PUSCH in the bandwidth part depends on the whether the slot is even- 
numbered or odd-numbered 

• Transport block data source. You can use one of the following standard PN sequences: 
'PN9-ITU', 'PN9', 'PNll', 'PN15', 'PN23'. The seed for the generator can be specified 
using a cell array in the form { ' PN9 ' , seed}. If no seed is specified, the generator is 
initialized with all ones 


pusch = []; 

pusch(l).Enable = 1; 

pusch(l).BWP = 1; 

pusch(l).Power = 0; 

pusch(l).EnableCoding = 1; 

pusch(l).NID = 1; 

pusch(l).RNTI = 0; 

pusch(l).TransformPrecoding = 0; 

pusch(l).TargetCodeRate = 0.47; 


% Enable PUSCH config 
% Bandwidth part 
% Power scaling in dB 
% Enable the UL-SCH transport coding 
% Scrambling for data part (0...1023) 

% RNTI 

% Transform precoding flag (0 or 1) 

% Code rate used to calculate transport bit 
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pusch(l).Xoh_PUSCH = 0; 

% Transmission settings 

pusch(l).TxScheme = 'codebook 1 ; 

pusch(l).Modulation = 'QPSK 1 ; 

pusch(l).NLayers = 2; 

pusch(l).NAntennaPorts = 4; 

pusch(l).TPMI = 0; 

pusch(l).RVSequence = [0231]; 

pusch(l).IntraSlotFreqHopping = 'disabled'; 

pusch(l).RBOffset = 10; 

% Multi-slot transmission 

pusch(l).InterSlotFreqHopping = 'enabled'; 

% Data source 

pusch(l).DataSource = ' PN9' ; 

Allocation 


% Overhead. It is one of the set {0,6,12,1! 


% Transmission scheme ('codebook','nonCodei 
% 'pi/2-BPSK','QPSK','16QAM','64QAM','256Q/ 
% Number of PUSCH layers (1...4) 

% Number of antenna ports (1,2,4). It must 
% Transmitted precoding matrix indicator (( 
% RV sequence to be applied cyclically acre 
% Intra-slot frequency hopping ('enabled', 
% Resource block offset for second hop 


% Inter-slot frequency hopping ('enabled', 


% Transport block data source 


You can set the following parameters to control the PUSCH allocation. 

• PUSCH mapping type. It can be either 'A' or 'B'. 

• Symbols in a slot where the PUSCH is mapped to. It needs to be a contiguous 
allocation. For PUSCH mapping type 'A', the start symbol within a slot must be zero 
and the length can be from 4 to 14 (for normal CP) and up to 12 (for extended CP). For 
PUSCH mapping type 'B', the start symbol can be from any symbol in the slot 

• Slots in a frame used for the PUSCH 

• Period of the allocation in slots. If this is empty it indicates no repetition 

• The allocated PRBs are relative to the BWP 

pusch(l).PUSCHMappingType = 'A'; 
pusch(l).AllocatedSymbols = 0:13; 
pusch(l).AllocatedSlots = [01]; 
pusch(l).AllocatedPeriod = 5; 
pusch(l).AllocatedPRB = 0:10; 

DM-RS Configuration 

The following DM-RS parameters can be set 
% DM-RS configuration (TS 38.211 section 6.4.1.1) 

pusch(l).DMRSConfigurationType =1; % DM-RS configuration type (1,2) 


% PUSCH mapping type ('A'(slot-wise),'B'(non s' 
% Range of symbols in a slot 
% Allocated slots indices 

% Allocation period in slots (empty implies no 
% PRB allocation 
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pusch(l).NumCDMGroupsWithoutData = 2; 

pusch(l).PortSet = [02]; 

pusch(l).DMRSTypeAPosition = 2; 

pusch(l).DMRSLength = 1; 

pusch(l).DMRSAdditionalPosition = 2; 

pusch(l).NIDNSCID = 1; 

pusch(l).NSCID = 0; 

pusch(l).NRSID = 0; 

pusch(l).PowerDMRS = 0; 

pusch(l).GroupHopping = 'enable 1 ; 


Number of DM-RS CDM groups without data. The \ 
DM-RS ports to use for the layers. The number 
Mapping type A only. First DM-RS symbol posit; 
Number of front-loaded DM-RS symbols (l(singl< 


Additional 
Scrambling 
Scrambling 
Scrambling 
Additional 
{'enable', 


DM-RS symbol positions (max range 
identity for CP-OFDM (0...65535). 
initialization for CP-OFDM (0,1) 
identity for DFT-s-OFDM DM-RS (0.. 
power boosting in dB 
'disable','neither'}. This paramete 


The parameter GroupHopping is used in DM-RS sequence generation when transform 
precoding is enabled. This can be set to 


• 'enable' to indicate the presence of group hopping. It is configured by higher-layer 
parameter sequenceGroupHopping 

• 'disable' to indicate the presence of sequence hopping. It is configured by higher-layer 
parameter sequenceHopping 

• 'neither' to indicate both group hopping and sequence hopping are not present 


Note: The number of DM-RS CDM groups without data depends on the configuration 
type. The maximum number of DM-RS CDM groups can be 2 for DM-RS configuration 
type 1 and it can be 3 for DM-RS configuration type 2. 


UCI on PUSCH 


The following parameters must be set to transmit UCI on PUSCH in overlapping slots: 

• Disable UL-SCH transmission on the overlapping slots of PUSCH (1/0). When set to 1, 

UL-SCH transmission is disabled on PUSCH. The example considers there is UL-SCH 
transmission all the time on PUSCH. A provision is provided to disable the UL-SCH 
transmission on the overlapping slots of PUSCH and PUCCH 

• BetaOf f setACK, BetaOf f setCSIl and BetaOf f setCSI2 can be set from the tables 
9.3-1, 9.3-2 TS 38.213 Section 9.3 

• ScalingFactor is provided by higher layer parameter scaling, as per TS 38.212, 

Section 6.3.2.4. The possible value is one of the set {0.5, 0.65, 0.8, 1}. This is used to 
limit the number of resource elements assigned to UCI on PUSCH 

pusch(l) .DisableULSCH = 1; % Disable UL-SCH on overlapping slots of PUSCH ; 

pusch(l).BetaOffsetACK =1; % Power factor of HARQ-ACK 

pusch(l).BetaOffsetCSIl =2; % Power factor of CSI part 1 
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pusch(l).BetaOffsetCSI2 =2; % Power factor of CSI part 2 

pusch(l).ScalingFactor =1; % Scaling factor (0.5, 0.65, 0.8, 1) 

Specifying Multiple PUSCH Instances 

A second PUSCH sequence instance is specified next using the second BWP. 

pusch(2) = pusch(l); 

pusch(2).Enable = 1; 

pusch(2).BWP = 2; 

pusch(2).AllocatedSymbols = 0:11; 

pusch(2).AllocatedSlots = [5678]; 

pusch(2).AllocatedPRB = 5:10; 

pusch(2).AllocatedPeriod = 10; 

pusch(2).TransformPrecoding = 1; 

pusch(2).IntraSlotFreqHopping = 'disabled'; 

pusch(2).GroupHopping = 'neither 1 ; 

pusch(2).NLayers = 1; 

pusch(2).PortSet = 1; 

pusch(2).RNTI = 0; 

Waveform Generation 

This section collects all the parameters into the carrier configuration and generates the 
waveform. 

% Collect together channel oriented parameter sets into a single 
% configuration 

waveconfig.Carriers = carriers; 
waveconfig.BWP = bwp; 
waveconfig.PUCCH = pucch; 
waveconfig.PUSCH = pusch; 

% Generate complex baseband waveform 

[waveform,bwpset] = hNRUplinkWaveformGenerator(waveconfig); 
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The waveform generator also plots the SCS carrier alignment and the resource grids for 
the bandwidth parts (this is controlled by the field DisplayGridsin the carrier 
configuration). The following plots are generated: 

• Resource grid showing the location of the components (PUCCH and PUSCH) in each 
BWP. This does not plot the power of the signals, just their location in the grid 

• Schematic diagram of SCS carrier alignment with the associated guardbands 

• Generated waveform in the freguency domain for each BWP. This includes the PUCCH 
and PUSCH instances 

The waveform generator function returns the time domain waveform and a struct array 
bwpset, which contains the following fields: 
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• The resource grid corresponding to this BWP 

• The resource grid of the overall bandwidth containing the channels and signals in this 
BWP 

• An info structure with information corresponding to the BWP. The contents of this info 
structure for the first BWP are shown below: 


disp( 1 Information associated to BWP 1:') 
disp(bwpset(l).Info) 


Information associated to BWP 1: 


SamplingRate 

Nfft 


61440000 

4096 


Windowing 
CyclicPrefixLengths 
SymbolLengths 
NSubcarriers 
SubcarrierSpacing 
SymbolsPerSlot 
StotsPerSubframe 
SymbolsPerSubframe 
SamplesPerSubframe 
Subf ramePeriod 
Midpoints 
WindowOverlap 
k0 


10 

[1x14 double] 

[1x14 double] 

3240 

15 

14 

1 

14 

61440 

1.0000e-03 
[1x141 double] 

[10 10 10 10 10 10 10 10 10 10 10 10 10 10 ] 
0 


Note that the generated resource grid is a 3D matrix where the different planes represent 
the antenna ports. For the different physical channels and signals the lowest port is 
mapped to the first plane of the grid. 


See Also 

System Objects 

nrULSCH 

Functions 

nrPUCCHO I nrPUCCHl I nrPUCCH2 I nrPUCCH3 I nrPUCCH4 I nrPUSCH 
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See Also 


More About 

• "5G NR Downlink Carrier Waveform Generation" on page 3-2 
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Synchronization Signal Blocks and Bursts 

This example shows how to generate a synchronization signal block (SSB) and generate 
multiple SSBs to form a synchronization signal burst (SS burst). The channels and signals 
that form a synchronization signal block (primary and secondary synchronization signals, 
physical broadcast channel) are created and mapped into a matrix representing the block. 
Finally a matrix representing a synchronization signal burst is created, and each 
synchronization signal block in the burst is created and mapped into the matrix. 

SS/PBCH block 

TS 38.211 Section 7.4.3.1 defines the Synchronization Signal / Physical Broadcast 
Channel (SS/PBCH) block as 240 subcarriers and 4 OFDM symbols containing the 
following channels and signals: 

• Primary synchronization signal (PSS) 

• Secondary synchronization signal (SSS) 

• Physical broadcast channel (PBCH) 

• PBCH demodulation reference signal (PBCH DM-RS) 

In other documents, for example TS 38.331, the SS/PBCH is termed "synchronization 
signal block" or "SS block". 

Create a 240-by-4 matrix representing the SS/PBCH block: 
ssblock = zeros([240 4]) 

ssblock = 240x4 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 

0 0 0 0 
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Primary Synchronization Signal (PSS) 
Create the PSS for a given cell identity: 
ncellid = 17; 

pssSymbols = nrPSS(ncellid) 

pssSymbols = 127xl 


-1 

-1 

-1 

-1 

-1 

-1 

1 

1 

1 

-1 


The variable pssSymbols is a column vector containing the 127 BPSK symbols of the 
PSS. 

Create the PSS indices: 
psslndices = nrPSSIndices; 

The variable psslndices is a column vector of the same size as pssSymbols. The value 
in each element of psslndices is the linear index of the location in the SS/PBCH block 
to which the corresponding symbols in pssSymbols should be mapped. Therefore the 
mapping of the PSS symbols to the SS/PBCH block can be performed with a simple 
MATLAB assignment, using linear indexing to select the correct elements of the SS/PBCH 
block matrix: 

ssblock(psslndices) = pssSymbols; 

Plot the SS/PBCH block matrix to show the location of the PSS: 

imagesc(abs(ssblock)); 
caxis([0 4]); 
axis xy; 

xlabel('OFDM symbol 1 ); 
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ylabel( 'Subcarrier’ ); 

title( 1 SS/PBCH block containing PSS ); 

SS/PBCH block containing PSS 
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Secondary Synchronization Signal (SSS) 

Create the SSS for the same cell identity as configured for the PSS: 
sssSymbols = nrSSS(ncellid) 

sssSymbols = 127x1 

-1 

1 

-1 

-1 
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-1 

1 

-1 

1 

-1 

1 


Create the SSS indices and map the SSS symbols to the SS/PBCH block, following the 
same pattern used for the PSS. Note that a scaling factor of 2 is applied to the SSS 
symbols, to represent fess i n TS 38.211 Section 7.4.3.1.2: 


ssslndices = nrSSSIndices; 
ssblock(ssslndices) = 2 * sssSymbols; 


The default form of the indices is 1-based linear indices, suitable for linear indexing of 
MATLAB matrices like ssblockas already shown. However, the NR standard documents 
describe the OFDM resources in terms of OFDM subcarrier and symbol subscripts, using 
0-based numbering. For convenient cross-checking with the NR standard, the indices 
functions accept options to allow the indexing style (linear index versus subscript) and 
base (0-based versus 1-based) to be selected: 


sssSubscripts 


nrSSSIndices( 1 IndexStyle 1 , 1 subscript 1 , 1 IndexBase 1 , 1 Obased 1 ) 


sssSubscripts = 127x3 uint32 matrix 

56 2 0 

57 2 0 

58 2 0 

59 2 0 

60 2 0 

61 2 0 

62 2 0 

63 2 0 

64 2 0 

65 2 0 


It can be seen from the subscripts that the SSS is located in OFDM symbol 2 (0-based) of 
the SS/PBCH block, starting at subcarrier 56 (0-based). 

Plot the SS/PBCH block matrix again to show the locations of the PSS and SSS: 
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imagesc(abs(ssblock)); 
caxis([0 4]); 
axis xy; 

xlabel('OFDM symbol ); 
ylabel( 'Subcarrier' ); 

title( 1 SS/PBCH block containing PSS and SSS' ); 


SS/PBCH block containing PSS and SSS 
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Physical Broadcast Channel (PBCH) 


The PBCH carries a codeword of length 864 bits, created by performing BCH encoding of 
the master information block (MIB). For more information on BCH coding, see the 
functions nrBCH and nrBCHDecode and their use in the "NR Synchronization 
Procedures" example. Here a PBCH codeword consisting of 864 random bits is used: 
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cw = randi([0 1],864,1); 

The PBCH modulation consists of the following steps as described in TS 38.211 Section 
7.3.3: 


• Scrambling 

• Modulation 

• Mapping to physical resources 


Scrambling and modulation 


Multiple SS/PBCH blocks are transmitted across half a frame, as described in the cell 
search procedure in TS 38.213 Section 4.1. Each SS/PBCH block is given an index from 
0...L - 1, where L is the number SS/PBCH blocks in the half frame. The scrambling 
seguence for the PBCH is initialized according to the cell identity ncellid, and the 
subseguence used to scramble the PBCH codeword depends on the value v, 2 or 3 LSBs 
of SS/PBCH block index, as described in TS 38.211 Section 7.3.3.1. In this example, v = 0 
is used. The function nrPBCH creates the appropriate subseguence of the scrambling 
seguence, performs scrambling and then performs QPSK modulation: 


v = 0; 

pbchSymbols = nrPBCH(cw,ncellid,v) 

pbchSymbols = 432x1 complex 


-0.7071 + 0.7071i 
-0.7071 + 0.707H 
-0.7071 + 0.7071i 
-0.7071 - 0.7071i 
0.7071 + 0.7071i 
-0.7071 + 0.7071i 
-0.7071 + 0.7071i 
0.7071 - 0.7071i 
0.7071 + 0.7071i 
0.7071 + 0.7071i 


Mapping to resource elements 

Create the PBCH indices and map the PBCH symbols to the SS/PBCH block: 

pbchlndices = nrPBCHIndices(ncellid); 
ssblock(pbchlndices) = 3 * pbchSymbols; 
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Plot the SS/PBCH block matrix again to show the locations of the PSS, SSS and PBCH: 

imagesc(abs(ssblock)); 
caxis([0 4]); 
axis xy; 

xlabel('OFDM symbol 1 ); 
ylabel( 'Subcarrier' ); 

title( 1 SS/PBCH block containing PSS, SSS and PBCH 1 ); 


SS/PBCH block containing PSS, SSS and PBCH 
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PBCH Demodulation Reference Signal (PBCH DM-RS) 

The final component of the SS/PBCH block is the DM-RS associated with the PBCH. 
Similar to the PBCH, the DM-RS seguence used derives from the SS/PBCH block index 
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and is configured using the variable z'ssb described in TS 38.211 Section 7.4.1.4.1. Here 
z'ssb = 0 is used: 


ibar_SSB = 0; 

dmrsSymbols = nrPBCHDMRS(nceUid,ibar_SSB) 

dmrsSymbols = 144-x-l complex 


0.7071 - 0.7071i 
0.7071 + 0.7071i 
-0.7071 + 0.7071i 
-0.7071 + 0.7071i 
0.7071 - 0.7071i 
0.7071 + 0.7071i 
0.7071 - 0.7071i 
-0.7071 - 0.7071i 
-0.7071 - 0.7071i 
0.7071 + 0.7071i 


Note thatTS 38.211 Section 7.4.1.4.1 defines an intermediate variable z'ssb which is 
defined identically to v described previously for the PBCH. 

Create the PBCH DM-RS indices and map the PBCH DM-RS symbols to the SS/PBCH 
block: 

dmrslndices = nrPBCHDMRSIndices(nceltid); 
ssblock(dmrslndices) = 4 * dmrsSymbols; 

Plot the SS/PBCH block matrix again to show the locations of the PSS, SSS, PBCH and 
PBCH DM-RS: 

imagesc(abs(ssblock)); 
caxisf[0 4]); 
axis xy; 

xlabelf'OFDM symbol 1 ); 
ylabelf 'Subcarrier' ); 

titlef 'SS/PBCH block containing PSS, SSS, PBCH and PBCH DM-RS'); 


3-39 



Subcarrier 


3 Tutorials 


200 


150 


100 


50 


SS/PBCH block containing PSS, SSS, PBCH and PBCH DM-RS 



0.5 1 1.5 2 2.5 3 3.5 4 4.5 

OFDM symbol 


Generating an SS burst 

An SS burst, consisting of multiple SS/PBCH blocks, can be generated by creating a 
larger grid and mapping SS/PBCH blocks into the appropriate locations, with each SS/ 
PBCH block having the correct parameters according to the location. 

Create SS burst grid 

In the NR standard, OFDM symbols are grouped into slots, subframes and frames. As 
defined in TS 38.211 Section 4.3.1, there are 10 subframes in a frame, and each subframe 
has a fixed duration of 1ms. Each SS burst has a duration of half a frame, and therefore 
spans 5 subframes: 

nSubframes = 5 
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nSubframes = 5 

TS 38.211 Section 4.3.2 defines each slot as having 14 OFDM symbols (for normal cyclic 
prefix length) and this is fixed: 

symbolsPerSlot = 14 

symbolsPerSlot = 14 

However, the number of slots per subframe varies and is a function of the subcarrier 
spacing. As the subcarrier spacing increases, the OFDM symbol duration decreases and 
therefore more OFDM symbols can be fitted into the fixed subframe duration of 1ms. 

There are 5 subcarrier spacing configurations p = 0. . . 4, with the corresponding 

subcarrier spacing being 15-2^ kHz. In this example we shall use p = 1, corresponding to 
30 kHz subcarrier spacing: 

mu = 1 

mu = 1 


The number of slots per subframe is 2^, as doubling the subcarrier spacing halves the 
OFDM symbol duration. Note that definition of a slot in NR is different from LTE: a 
subframe in LTE consists of 2 slots of 7 symbols (for normal cyclic prefix) whereas in NR, 
a subframe using the LTE subcarrier spacing (p = 0, 15 kHz) consists of 1 slot of 14 
symbols. 


Calculate the total number of OFDM symbols in an SS burst: 
nSymbols = symbolsPerSlot * 2~mu * nSubframes 

nSymbols = 140 

Create an empty grid for the whole SS burst: 
ssburst = zeros([240 nSymbols]) 

ssburst = 240x140 


0 0 0 
0 0 0 
0 0 0 
0 0 0 
0 0 0 


0 0 
0 0 
0 0 
0 0 
0 0 


0 0 0 0 
0 0 0 0 
0 0 0 0 
0 0 0 0 
0 0 0 0 


0 

0 

0 

0 

0 


0 0 
0 0 
0 0 
0 0 
0 0 


0 

0 

0 

0 

0 


0 

0 

0 

0 

0 
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0 0 0 
0 0 0 
0 0 0 
0 0 0 
0 0 0 


0 0 0 0 
0 0 0 0 
0 0 0 0 
0 0 0 0 
0 0 0 0 


0 0 0 
0 0 0 
0 0 0 
0 0 0 
0 0 0 


0 0 
0 0 
0 0 
0 0 
0 0 


0 0 
0 0 
0 0 
0 0 
0 0 


Define SS block pattern 

The pattern of SS/PBCH blocks within an SS burst is indirectly specified by the cell 
search procedure in TS 38.213, which describes the locations in which the UE may detect 
an SS/PBCH block. There are 5 block patterns, Case A - Case E, which have different 
subcarrier spacings and are applicable for different carrier frequencies. 

Create the indices of the first symbols in the candidate SS/PBCH blocks for block pattern 
Case B, which has L = 8 blocks per burst: 

n = [0, 1]; 

firstSymbotlndex = [4; 8; 16; 20] + 28*n; 
firstSymbolIndex = firstSymbolIndex(:).' 

firstSymbotlndex = 1x8 

4 8 16 20 32 36 44 48 


Create SS burst content 

Now a loop can be created which generates each SS block and assigns it into the 

appropriate location of the SS burst. Note the following: 

• The code re-uses various variables created earlier in this example (PSS, SSS, and 4 
sets of indices) 

• The PSS and SSS are independent of the SS/PBCH block index, so can be mapped into 
the SS block before the loop 

• The PBCH indices and PBCH DM-RS indices are independent of the SS/PBCH block 
index, so do not need updated in the loop 

• ; SSB/ ! ssb and v are set up according to the rules in TS 38.211 Sections 7.3.3.1 and 
7.4.1.4.1 for the case of L = 8. 

• Each channel / signal has been scaled in order to give them different colors in the final 
plot 
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ssblock = zeros([240 4]); 
ssblock(psslndices) = pssSymbols; 
ssblock(ssslndices) = 2 * sssSymbols; 

for ssblndex = l:length(firstSymbolIndex) 

i_SSB = mod(ssblndex,8); 
ibar_SSB = i_SSB; 
v = i_SSB; 

pbchSymbols = nrPBCH(cw,ncellid,v); 
ssblock(pbchlndices) = 3 * pbchSymbols; 

dmrsSymbols = nrPBCHDMRS(ncellid,ibar_SSB); 
ssblock(dmrslndices) = 4 * dmrsSymbols; 

ssburst(:,firstSymbolIndex(ssblndex) + (0:3)) 


end 

Finally, plot the SS burst content: 

imagesc(abs(ssburst)); 
caxis([0 4]); 
axis xy; 

xlabel('OFDM symbol 1 ); 
ylabel( 'Subcarrier' ); 

title('SS burst, block pattern Case B 1 ); 


= ssblock; 
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Functions 

nrPBCH | nrPBCHDMRS | nrPBCHDMRSIndices | nrPBCHIndices | nrPSS 
nrPSSIndices | nrSSS | nrSSSIndices 

More About 

• "NR Synchronization Procedures" 
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Modeling Downlink Control Information 


This example describes the downlink control information (DCI) processing for the 5G New 
Radio communications system. Starting from a random DCI message, it models the 
message encoding followed by the physical downlink control channel (PDCCH) processing 
on the transmit end. Corresponding receiver components recover the transmitted control 
information elements. 

System Parameters 


Set parameters for a UE-specific search space. 


rng(211); 

nID = 23; 
rnti = 100; 

K = 64; 

E = 288; 

DCI Encoding 


% Set RNG state for repeatability 
% pdcch-DMRS-ScramblingID 

% C-RNTI for PDCCH in a UE-specific search space 
% Number of DCI message bits 
% Number of bits for PDCCH resources 


The DCI message bits based on a downlink format are encoded using the nrDCIEncode 
function, which includes the stages of CRC attachment, polar encoding and rate 
matching. 

dciBits = randi([0 1],K,1,' int8 1 ); 
dciCW = nrDCIEncode(dciBits,rnti,E); 

PDCCH Symbol Generation 


The encoded DCI bits (a codeword) are mapped onto the physical downlink control 
channel (PDCCH) using the nrPDCCH function which generates the scrambled, QPSK- 
modulated symbols. The scrambling accounts for the user-specific parameters. 

sym = nrPDCCH(dciCW,nID,rnti); 

For NR, the PDCCH symbols are then mapped to the resource elements of an OFDM grid 
which also has PDSCH, PBCH and other reference signal elements. These are followed by 
OFDM modulation and transmission over a channel. For simplicity, we directly pass the 
PDCCH symbols over an AWGN channel next. 
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Channel 

The PDCCH symbols are transmitted over an AWGN channel with a specified SNR, 
accounting for the coding rate and QPSK modulation. 

EbNo =3; % in dB 

bps =2; % bits per symbol, 2 for QPSK 

EsNo = EbNo + 10*logl0(bps); 
snrdB = EsNo + 10*logl0(K/E); 

rxSym = awgn(sym,snrdB, 'measured 1 ); 

PDCCH Decoding 

The received symbols are demodulated with known user-specific parameters and channel 
noise variance using the nrPDCCHDecode function. The soft output is the log-likelihood 
ratio for each bit in the codeword. 

noiseVar = 10.~(-snrdB/10); % assumes unit signal power 

rxCW = nrPDCCHDecode(rxSym,nID,rnti,noiseVar); 

DCI Decoding 

An instance of the received PDCCH codeword is then decoded by the nrDCIDecode 
function. This includes the stages of rate recovery, polar decoding and CRC decoding to 
recover the transmitted information bits. 

listLen =8; % polar decoding list length 

[decDCIBits,mask] = nrDCIDecodefrxCW,K,listLen); 

isequal(mask,rnti) 
isequal(decDCIBits,dciBits) 


logical 

1 


ans = 
logical 
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1 

The output mask matches the C-RNTI used for the UE, thereby confirming the message 
recipient. For the chosen system parameters, the decoded information matches the 
transmitted information bits. 


See Also 

Functions 

nrDCIDecode | nrDCIEncode | nrPDCCH | nrPDCCHDecode 

More About 

• "Downlink Control Processing and Procedures" 
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5G New Radio Polar Coding 

This example highlights the new polar channel coding technique chosen for 5G New 
Radio (NR) communications system. Of the two main types of code constructions specified 
by 3GPP this example models the CRC-Aided Polar (CA-Polar) coding scheme. This 
example describes the main components of the polar coding scheme with individual 
components for code construction, encoding and decoding along-with rate-matching. It 
models a polar-coded QPSK-modulated link over AWGN and presents Block-Error-Rate 
results for different message lengths and code rates for the coding scheme. 

Introduction 

The selection of polar codes as the channel coding technique for control channels for 5G 
NR communications system has proven the merits of Arikan's [ 1 ] discovery and will 
establish their application in commercial systems [ 6 ]. Based on the concept of channel 
polarization, this new coding family is capacity achieving as opposed to just capacity 
approaching. With better or comparable performance than LDPC and turbo codes, it 
supersedes the tail-biting convolutional codes used in LTE systems for control channels. It 
is applied for downlink and uplink control information (DCI/UCI) for the enhanced mobile 
broadband (eMBB) use case, as well as the broadcast channel (BCH). Alternatively, the 
channel coding scheme for data channels for eMBB is specified to be flexible LDPC for all 
block sizes. 

This example highlights the components to enable a polar coding downlink simulation 
using QPSK modulation over an AWGN channel. In the following sections, the individual 
polar coding components are further detailed. 

s = rng(100); % Seed the RNG for repeatability 

Specify the code parameters used for a simulation. 

% Code parameters 
K = 54; 

E = 124; 

EbNo = 0.8; 

L = 8; 

numFrames = 10; 
linkDir = 1 DL' ; 


Message length in bits, including CRC, K > 30 
Rate matched output length, E <= 8192 

EbNo in dB 

List length, a power of two, [1248] 

Number of frames to simulate 

Link direction: downlink ('DL') OR uplink ('UL') 
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Polar Encoding 

The following schematic details the transmit-end processing for the downlink, with 
relevant components and their parameters highlighted. 


Downlink rate-K/E encoding 



To Mapper 
(e g. QPSK) 


For the downlink, the input bits are interleaved prior to polar encoding. The CRC bits 
appended at the end of the information bits are thus distributed for the CA-Polar scheme. 
This interleaving is not specified for the uplink. 


The polar encoding uses an SNR-independent method where the reliability of each 
subchannel is computed offline and the ordered seguence stored for a maximum code 
length [ 6 ]. The nested property of polar codes allows this seguence to be used for any 
code rate and all code lengths smaller than the maximum code length. 


This seguence is computed for given rate-matched output length, E, and information 
length, K, by the function nrPolarEncode, which implements the non-systematic 
encoding of the input K bits. 


if strcmpClinkDir, ' DL ) 
% Downlink scenario 
crcLen = 24; % 

poly = '24C' ; % 

nPC =0; % 

nMax =9; % 

ilL = true; % 

iBIL = false; % 

else 


(K >= 36, including CRC bits) 

Number of CRC bits for DL, Section 5.1, [6] 

CRC polynomial 

Number of parity check bits, Section 5.3.1.2, [6] 
Maximum value of n, for 2~n, Section 7.3.3, [6] 
Interleave input, Section 5.3.1.1, [6] 

Interleave coded bits, Section 5.4.1.3, [6] 


% Uplink scenario (K > 30, including CRC bits) 
crcLen = 11; 
poly = 'll' ; 
nPC = 0; 


nMax = 10; 
ilL = false; 
iBIL = true; 
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The following schematic details the transmit-end processing for the uplink, for a payload 
size greater than 19 bits and no code-block segmentation, with relevant components and 
their parameters highlighted. 


Uplink rate-K/E encoding 



To Mapper 
(e g. QPSK) 


Rate Matching and Rate Recovery 

The polar encoded set of bits (N) are rate-matched to output the specified number of bits 
(E) for resource element mapping [ 7 ]. The coded bits are sub-block interleaved and 
passed to a circular buffer of length N. Depending on the desired code rate and selected 
values of K, E, and N, either of repetition (E >= N), and puncturing or shortening (E < N) 
is realized by reading the output bits from the buffer. 

• For puncturing, E bits are taken from the end 

• For shortening, E bits are taken from the start 

• For repetition, E bits are repeated modulo N. 

For the downlink, the selected bits are passed on to the modulation mapper, while for the 
uplink, they are further interleaved prior to mapping. The rate-matching processing is 
implemented by the function nrRateMatchPolar. 

At the receiver end, rate recovery is accomplished for each of the cases 

• For puncturing, corresponding LLRs for the bits removed are set to zero 

• For shortening, corresponding LLRs for the bits removed are set to a large value 

• For repetition, the set of LLRs corresponding to first N bits are selected. 

The rate-recovery processing is implemented by the function nrRateRecoverPolar. 

R = K/E; % Effective code rate 

bps =2; % bits per symbol, 1 for BPSK, 2 for QPSK 

EsNo = EbNo + 10*logl0(bps); 

snrdB = EsNo + 10*logl0(R); % in dB 

noiseVar = 1./(10.^(snrdB/10)); 
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% Channel 

chan = comm.AWGNChannel( 1 NoiseMethod 1 , 1 Variance 1 , 'Variance 1 ,noiseVar); 

Polar Decoding 

The implicit CRC encoding of the downlink (DCI or BCH) or uplink (UCI) message bits 
dictates the use of the CRC-Aided Successive Cancellation List Decoding (CA-SCL) [ 3 ] as 
the channel decoder algorithm. It is well known that CA-SCL decoding can outperform 
turbo or LDPC codes and this was one of the major factors in the adoption of polar codes 
by 3GPE 

Tal & Vardy [ 2 ] describe the SCL decoding algorithm in terms of likelihoods 
(probabilities). However, due to underflow, the inherent computations are numerically 
unstable. To overcome this issue, Stimming et.al. [ 5 ] offer the SCL decoding solely in the 
log-likelihood ratio (LLR) domain. The list decoding is characterized by the L parameter, 
which represents the number of most likely decoding paths retained. At the end of the 
decoding, the most likely code-path among the L paths is the decoder output. As L is 
increased, the decoder performance also improves, however, with a diminishing-retums 
effect. 

For an input message which is concatenated with a CRC, CA-SCL decoding prunes out 
any of the paths for which the CRC is invalid, if at least one path has the correct CRC. 

This additional insight in the final path selection improves the performance further, when 
compared to SCL decoding. For the downlink, a CRC of 24 bits is used, while for the 
uplink CRCs of 6 and 11 bits are specified, which vary on the value of K. 

The decoder is implemented by the function n rPola rDecode, which supports all three 
CRC lengths. The decoder function also accounts for the input bit interleaving specified at 
the transmitter for the downlink, prior to outputting the decoded bits. 

% Error meter 

ber = comm.ErrorRate; 

Frame Processing Loop 

This section shows how the prior described components for polar coding are used in a 
Block Error Rate (BLER) simulation. The simulation link is highlighted in the following 
schematic. 
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rate-K/E Encoder 



For each frame processed, the following steps are performed: 

• K- c rcLen random bits are generated, 

• A CRC is computed and appended to these bits 

• The CRC appended bits are polar encoded to the mother code block length 

• Rate-matching is performed to transmit E bits 

• The E bits are QPSK modulated 

• White Gaussian Noise of specified power is added 

• The noisy signal is soft QPSK demodulated to output LLR values 

• Rate recovery is performed accounting for either of puncturing, shortening or 
repetition 

• The recovered LLR values are polar decoded using the CA-SCL algorithm, including 
deinterleaving. 

• Off the decoded K bits, the first K- c rcLen bits are compared with those transmitted to 
update the BLER and bit-error-rate (BER) metrics. 

At the end of the simulation, the two performance indicators, BLER and BER, are 
reported. 

numferr = 0; 

for i = l:numFrames 
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% Generate a random message 
msg = randi([0 1],K-crcLen,l); 

% Attach CRC 

msgcrc = nrCRCEncode(msg,poly); 

% Polar encode 

encOut = nrPolarEncode(msgcrc,E,nMax,iIL); 

N = length(encOut); 

% Rate match 

modln = nrRateMatchPolar(encOut,K,E,iESIL); 

% Modulate 

modOut = nrSymbolModulate(modIn,' QPSK 1 ); 

% Add White Gaussian noise 
rSig = chan(modOut); 

% Soft demodulate 

rxLLR = nrSymbolDemodulate(rSig, 1 QPSK 1 ,noiseVar); 

% Rate recover 

decln = nrRateRecoverPolar(rxLLR,K,N,iBIL); 

% Polar decode 

decBits = nrPolarDecode(decln,K,E,L,nMax,ilL,crcLen); 
% Compare msg and decoded bits 

errStats = ber(double(decBits(l:K-crcLen)), msg); 
numferr = numferr + any(decBits(l:K-crcLen)~=msg); 


end 

disp(t 'Block Error Rate: 1 num2str(numferr/numFrames) ... 
Bit Error Rate: 1 num2str(errStats(1)) ... 

1 , at SNR = 1 num2str(snrdB) 1 dB 1 ]) 

rng(s); % Restore RNG 

Block Error Rate: 0, Bit Error Rate: 0, at SNR = 0.20002 dB 
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Results 

To get meaningful results, simulations have to be run for a longer duration. Using scripts 
which encapsulate the above processing into a function that supports C-code generation, 
the following results for different code rates and message lengths are presented for both 
link directions with QPSK modulation. 



SNR (dB) 
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SNR(dB) 


The above results were generated by simulating, for each SNR point, up to 1000 frame 
errors or a maximum of 100e3 frames, whichever occurred first. 

The BLER performance results indicate the suitability of polar codes in a communication 
link and their implicit support for rate-compatibility at the bit-level granularity. 

The use of C-code generation tools for the components reduces the execution time, a key 
concern for simulations. The C-code generation is enabled by MATLAB Coder™. 

Summary and Further Exploration 

This example highlights one of the polar coding schemes (CRC-Aided Polar) specified by 
3GPP for New Radio control channel information (DCI, UCI) and broadcast channel 
(BCH). It shows the use of components for all stages of the processing (encoding, rate- 
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matching, rate-recovery and decoding) and uses them in a link with QPSK over an AWGN 
channel. Highlighted performance results for different code rates and message lengths 
show agreement to published trends, within parametric and simulation assumption 
variations. 

Explore simple parameter variations (K, E, L) and their effect on BLER performance. The 
polar coding functions are implemented as open MATLAB® code to enable their 
application for both downlink/uplink control information and broadcast channel. The CA- 
Polar scheme is applicable for both 

• Downlink, for all message lengths, and 

• Uplink, for K > 30, with crcLen = 11, nPC = 0, nMax = 10, ilL = false, and 
iBIL = true. 

Refer to "Modeling Downlink Control Information" on page 3-45 and "NR Synchronization 
Procedures" examples, for the use of polar coding functions within the DCI and BCH 
functions respectively. 

The highlighted polar coding functions also support the Parity-Check polar coding 
construction and encoding. This is applicable for the uplink with UCI payloads in range 
18 <= K <= 25. This is supported by the uplink control coding functions n rllCIEncode 
and nrllCIDecode, which include code-block segmentation as well for appropriate values 
of K and E. 

Selected References 

1 Arikan, E., "Channel Polarization: A Method for constructing Capacity-Achieving 
Codes for Symmetric Binary-Input Memoryless Channels," IEEE Transactions on 
Information Theory, vol. 55, No. 7, pp. 3051-3073, July 2009. 

2 Tal, I, and Vardy, A., "List decoding of Polar Codes", IEEE Transactions on 
Information Theory, vol. 61, No. 5, pp. 2213-2226, May 2015. 

3 Niu, K., and Chen, K., "CRC-Aided Decoding of Polar Codes," IEEE Communications 
Letters, vol. 16, No. 10, pp. 1668-1671, Oct. 2012. 

4 Niu, K., Chen, K., and Lin, J.R., "Beyond turbo codes: rate compatible punctured polar 
codes", IEEE International Conference on Communications, pp. 3423-3427, 2013. 

5 Stimming, A. B., Parizi, M. B., and Burg, A., "LLR-Based Successive Cancellation List 
Decoding of Polar Codes", IEEE Transaction on Signal Processing, vol. 63, No. 19, 
pp.5165-5179, 2015. 

6 3GPP TS 38.212. "NR; Multiplexing and channel coding (Release 15)." 3rd Generation 
Partnership Project; Technical Specification Group Radio Access Network. 


3-56 



See Also 


7 Rl-1711729. "WF on circular buffer of Polar Code", 3GPPTSG RANWG1 meeting NR 

Ad-Hoc#2, Ericsson, Qualcomm, MediaTek, LGE. June 2017. 


See Also 

Functions 

nrPolarDecode|nrPolarEncode|nrRateMatchPolar|nrRateRecoverPolar 

More About 

• "Modeling Downlink Control Information" on page 3-45 

• "NR Synchronization Procedures" 
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LDPC Processing for DL-SCH and UL-SCH 

This example highlights the low-density parity-check (LDPC) coding chain for the 5G NR 
downlink and uplink shared transport channels (DL-SCH and UL-SCH). 

Shared Channel Parameters 


The example uses the DL-SCH to describe the processing, which also applies to the UL- 
SCH. 


Select parameters for a transport block transmitted on the downlink shared (DL-SCH) 
channel. 


rng(210); 


% Set RNG state for repeatability 


A = 10000; 
rate = 449/1024; 
rv = 0; 

modulation = 1 QPSK' ; 
nlayers = 1; 


% Transport block length, positive integer 
% Target code rate, 0<R<1 
% Redundancy version, 0-3 

% Modulation scheme, QPSK, 16QAM, 64QAM, 256QAM 
% Number of layers, 1-4 for a transport block 


Based on the selected transport block length and target coding rate, DL-SCH coding 
parameters are determined using the nrDLSCHInfo function. 

% DL-SCH coding parameters 
cbslnfo = nrDLSCHInfo(A,rate); 
disp( 'DL-SCH coding parameters') 
disp(cbslnfo) 

DL-SCH coding parameters 


CRC 

' 24A' 

L 

24 

BGN 

1 

C 

2 

Lcb 

24 

F 

244 

Zc 

240 

K 

5280 

N 

15840 


DL-SCH supports multi-codeword transmission (i.e. two transport blocks) while UL-SCH 
supports only a single codeword. UL-SCH also supports pi/2-BPSK modulation in addition 
to those listed above for DL-SCH. 
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Transport Block Processing using LDPC Coding 

Data delivered from the MAC layer to the physical layer is termed as a transport block. 
For the downlink shared channel (DL-SCH), a transport block goes through the 
processing stages of: 

• CRC attachment, 

• Code block segmentation and code block CRC attachment, 

• Channel coding using LDPC, 

• Rate matching and code block concatenation 

before being passed on to the physical downlink shared channel (PDSCH) for scrambling, 
modulation, layer mapping and resource/antenna mapping. Each of these stages is 
performed by a function as shown next. 

% Random transport block data generation 
in = randi([0 1],A,1, 1 int8 1 ); 

% Transport block CRC attachment 
tbln = nrCRCEncode(in,cbsInfo.CRC); 

% Code block segmentation and CRC attachment 
cbsln = nrCodeBlockSegmentLDPC(tbIn,cbsInfo.BGN); 

% LDPC encoding 

enc = nrLDPCEncode(cbsln,cbslnfo.BGN); 

% Rate matching and code block concatenation 
outlen = ceil(A/rate); 

chin = nrRateMatchLDPC(enc,outlen,rv,modulation,nlayers); 

The output number of bits from the rate matching and code block concatenation process 
must match the bit capacity of the PDSCH, based on the available resources. In this 
example, as the PDSCH is not modeled, this is set to achieve the target code rate based 
on the transport block size previously selected. 

Similar processing applies for the UL-SCH, where the physical uplink shared channel 
(PUSCH) is the recipient of the UL-SCH codeword. The following schematics depict the 
processing for the two channels. 
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Refer to nrDLSCH and nrULSCH System objects that encapsulate the processing per 
transport block, with additional support for retransmissions. 

Channel 

A simple bipolar channel with no noise is used for this example. With the full PDSCH or 
PUSCH processing, one can consider fading channels, AWGN and other RF impairments 
as well. 

chOut = double(l-2*(chIn)); 

Receive Processing using LDPC Decoding 

The receive end processing for the DL-SCH channel comprises of the corresponding dual 
operations to the transmit end that include 
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• Rate recovery 

• LDPC decoding 

• Code block desegmentation and CRC decoding 

• Transport block CRC decoding 

Each of these stages is performed by a function as shown next. 

% Rate recovery 

raterec = nrRateRecoverLDPC(chOut,A,rate,rv,modulation,nlayers); 

% LDPC decoding 

decBits = nrLDPCDecode(raterec,cbslnfo.BGN,25); 

% Code block desegmentation and CRC decoding 

[blk,blkErr] = n rCodeBlockDesegmentLDPC(decBits,cbslnfo.BGN,A+cbsInfo.L); 

disp(t 1 CRC error per code-block: [' num2str(blkErr) ']']) 

% Transport block CRC decoding 
[out.tbErr] = nrCRCDecode(blk,cbslnfo.CRC); 

disp([ 'Transport block CRC error: 1 num2str(tbErr)]) 

disp([ 1 Recovered transport block with no error: 1 num2str(isequal(out,in))]) 

CRC error per code-block: [0 0] 

Transport block CRC error: 0 

Recovered transport block with no error: 1 

As the displays indicate, there are no CRC errors at both the code-block and transport 
block levels. This leads to the transport block being recovered and decoded with no 
errors, as expected, for a noiseless channel. 

Refer to nrDLSCHDecoder and nrllLSCHDecoder System objects that encapsulate the 
receive processing per codeword, with additional soft-combining of retransmissions for 
improved performance. 


See Also 

System Objects 

nrDLSCH I nrDLSCHDecoder I nrULSCH I nrllLSCHDecoder 
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Functions 

nrCRCDecode | nrCRCEncode | nrCodeBlockDesegmentLDPC | 
nrCodeBlockSegmentLDPC | nrDLSCHInfo | nrLDPCDecode | nrLDPCEncode 
nrRateMatchLDPC|nrRateRecoverLDPC|nrULSCHInfo 

More About 

• "NR PDSCH Throughput" 

• "NR PUSCH Throughput" 
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